Document gtk_icon_theme_add_resource_path

diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 5896a799cdfe3bbb2ce8c55204bea338f3311782..5111caa13a9fef32d4f4faab59094e6ffb2a4fdd 100644 (file)
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -6695,6 +6695,7 @@ gtk_icon_theme_set_search_path
 gtk_icon_theme_get_search_path
 gtk_icon_theme_append_search_path
 gtk_icon_theme_prepend_search_path
+gtk_icon_theme_add_resource_path
 gtk_icon_theme_set_custom_theme
 gtk_icon_theme_has_icon
 gtk_icon_theme_lookup_icon

diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index d0c1d08879c3f23031338e312d227ec81eeafc79..c23b300dc3a701d08dce9192c5faaad5f78c0b96 100644 (file)
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -1000,6 +1000,22 @@ gtk_icon_theme_prepend_search_path (GtkIconTheme *icon_theme,
   do_theme_change (icon_theme);
 }
 
+/**
+ * gtk_icon_theme_add_resource_path:
+ * @icon_theme: a #GtkIconTheme
+ * @path: a resource path
+ *
+ * Adds a resource path that will be looked at when looking
+ * for icon theme contents, similar to search paths. The resources
+ * should be located in a subdirectory starting with the theme name,
+ * like this:
+ * `@path/hicolor/16x16/actions/run.png`.
+ *
+ * This function should be used to make application-specific icons
+ * available as part of the icon theme.
+ *
+ * Since: 3.14
+ */
 void
 gtk_icon_theme_add_resource_path (GtkIconTheme *icon_theme,
                                   const gchar  *path)